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Idea i breu descripcio: 

- La idea va sortir de la manca d’aplicacions que hi ha per poder parlar amb la gent que 
tens a prop teu ni que no les coneguis de res. Per exemple, a un festival de musica la gent 
pot parlar tothom a la vegada per un canal sense haver-de donar-se cap tipus de contacte 
ni informacio. I llavors hem desenvolupat aquesta aplicacio, amb la qual podras parlar 
amb la gent que tinguis al teu voltant, dins d’un radi de 1/2 km. 
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L’aplicacio: 

Descripcio: 

Quan entres per primer cop a I’aplicacio tindras que registrar-te amb el teu compte de 
Google i introduir un nom d’usuari, amb el qual t'identificaran els altres usuaris de 
I’aplicacio, per tal de poder accedir-hi. 

Un cop registrat i/o loguejat et trobaras amb tres pestanyes diferents. Una de xat, una de 
configuracio i una d’informacio. 

Amb el xat tindrem una caixa de text per poder escriure i un boto per enviar els missatges. 
A mes, quan facis "scroll” apareixera un boto per tal de poder baixar a baix de tot 
rapidament. 

Quan envii's un missatge apareixera a la dreta dins d’una caixa on diu I’ hora en la que 
s’ha enviat i una rodona (indicant que el missatge encara no s’ha enviat). Quan s’hagi 
transmes, aquesta rodona es transformara en un "tick”. 

Al rebre un missatge, aquest es posara a I’esquerra tambe dins d’una caixa que indica 
I’hora que s’ha enviat i el nom de I’usuari que I’ha enviat. 

A la pestanya d’informacio et trobaras amb un mapa amb un cercle, el qual indica la zona 
en la que estas. Podras intercanviar missatges amb tothom que hi estigui dins. Tambe 
podras veure el teu nom d’usuari, el nombre d’usuaris connectats en la mateixa zona, i si 
hi fas clic, apareix una llista amb els noms dels usuaris. 

A la pestanya de configuracio podras configurar el comportament de I’aplicacio i del 
compte d’usuari. 

La primera opcio que et trobaras es la de canviar els tons del xat, la qual obrira la teva 
galeria i podras triar una imatge. Seguidament trobaras una opcio per poder desactivar el 
so de les notificacions, i una altra per poder canviar-lo. 

Asota esta I’opcio per poder desactivar I’aplicacio en quan estigui tancada. D’aquesta 
forma deixaras d’enviar la teva posicio i no rebras mes missatges. 

Finalment trobarem les opcions del perfil on hi ha I’opcio per poder canviar el teu nom 
d’usuari, el qual podra ser una cadena d’entre quatre i dotze caracters sempre i quan no hi 
hagi ningu que es digui igual. Tambe podras desloguejar-te, i per ultim, eliminar el teu 
compte. 
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Funcionament: 


Breu descripcio: 

L’aplicacio envia cada uns segons la teva localitzacio a una API la qual calcula si estas 
dins d’alguna zona que ja existia previament, i si no la crea. Despres aquesta retorna FID 
de la zona i el mobil es subscriu a un topic amb aquest ID. 

Quan envies un missatge, el rebratothom qui estigui subscrit al mateix topic. Que significa 
que esta dins de la teva zona. 

Per gestionar els missatges i enviar-los a un topic hi ha un servidor que fa de enrutador i 
s’encarrega d’enviar-los a qui li toca. 

Com funciona internament: 

Quan obres I’aplicacio es llegeix si tens connexio a internet i si tens I’ubicacio activada, si 
no es aixi, I’aplicacio no et deixa enviar missatges. Tambe llegeix tots els missatges 
anteriors de la base de dades i els afegeix a la finestra del xat. 

Quan envies el missatge, s’afegeix automaticament a la base de dades, i s’envia. Si 
aquest no ho fa, quan el servei que envia els missatges es reconnecta el trona a enviar. 

La gestio dels missatges funciona amb un servei paral lel a I’aplicacio que gestiona totes 
les connexions d’aquesta amb I’exterior. Es a dir, cada uns segons agafa les coordenades 
del dispositiu i fa un PUT a I’API la qual calcula la zona a la qual esta i retorna la seva ID 
junt amb una llista d’usuaris que hi ha connectats i el centre de la zona (Per a la finestra 
d’informacio). Per altra banda, tambe controla els missatges. Quan tu envies un missatge, 
el servei I’envia al servidor el qual s’encarrega de gestionar-los. 

Al rebre un missatge, aquest es comunica amb I’aplicacio si esta oberta, i I’afegeix al xat. 
Mentre, s’introdueix a la base de dades on es guarden tots els missatges. I si I’aplicacio 
no esta oberta amb la finestra del xat, s’envia una notificacio al mobil amb I’autor i el 
contingut del missatge. 

A mes hi ha una serie de "listeners” els quals estan escoltant si hi ha internet i si tens la 
ubicacio activada, i de no ser aixi, se’t notifica demanant que ho activis o be que 
desactivis I’aplicacio amb I’opcio a les preferences. 
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Restful API: 


Rutes utilitzades pel client Android: 

■ POST /users 

- Rep un JSON pel body de la peticio amb el nom d’usuari desitjat i el correu. SI ha 
passat tots el ‘checks’ d’errors, crea un usuari i retorna un JSON amb un string (que sera 
una mena d’identificador), i el nom d’usuari . 


■ DELETE /users/{id} 

- Elimina I’usuari de la base de dades, aixo si, primer el desconnecta de la seva 
zona actual. 


■ PUT /users/{id}/coords 

- Actualitza la posicio actual de I’usuari i retorna un JSON amb informacio de la 
seva zona, {id, posicio, usuaris connectats} 


■ PUT /users/{id}/name 

- Rep un JSON pel body de la peticio amb el nou nom d’usuari desitjat, i si no es de 
cap usuari i compleix els requisits (tamany, caracters especials), I’actualitza, del contrari 
retorna un codi d’error, el qual el client Android sabra quin missatge mostrar. 


■ PUT /users/{id}/disconnect 

- Desconnecta I’usuari de la seva zona actual. S’utilitza per quan es tanca el mdbil, 
es desconnecta de I’aplicacio, o si no vol escoltar el xat el segon pla. 


■ GET /login?email={email}: 

- Intenta loguejar-se contra I’api amb el correu passat com a parametre. Si I’usuari 
existeix a la base de dades, retorna el mateix JSON que en: {POST /users}, un id i el nom 
d’usuari. 
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Links del projecte: 


Document 

Link 

Codi de la aplicacio 

https://gitlab.com/suricatesTeam/NearTalk 

Codi de la API 

https://gitlab.com/suricatesTeam/NearTalkRest 

Codi del servidor MQTT 

https://gitlab.com/suricatesTeam/NearTalk- 

MQTTServerGolang 

Android apk 

https://archive.org/download/docsNearTalk_201705/NearTal 

k.apk 

Link API 

https://neartalk-restfulapi.herokuapp.com/ 

Link MQTT server 

https://golang-cesarbiker.rhcloud.com/ 

Documentacio aplicacio 
Android 

https://archive.org/download/docsNearTalk_201705/Android 

Doc.tar.gz 

Documentacio API 

https://archive.org/download/docsNearTalk_201705/APIDoc 

■tar.gz 

Documentacio Servidor 

https://archive.org/download/docsNearTalk_201705/Server 

Doc.tar.gz 

Diagrama de classes 

Android 

https://ia601509.us.archive.org/27/items/docsNearTalk_201 

705/UMLAndroid.png 

Diagrama de classes API 

https://ia601509.us.archive.org/27/items/docsNearTalk 201 
705/UMLAPI.png 

Diagrama de classes MQTT 

https://ia601509.us.archive.org/27/items/docsNearTalk_201 

705/UMLServidor.png 

Cas d’us 

https://ia601509.us.archive.org/27/items/docsNearTalk_201 

705/NearTalk_usecase.png 

Analisi funcional / no 
funcional 

https://archive.org/download/docsNearTalk_201705/AnalisiF 

uncionalNoFuncional.odt 

FindBugs 

https://archive.org/download/docsNearTalk_201705/FindBu 

gs.odt 
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Estructura bases de dades 

https://archive.org/download/docsNearTalk_201705/Databa 

seDiagram.odt 

Recursos addicionals 

https://archive.org/download/docsNearTalk_201705/Resour 

ces.odt 

Llibreries addicionals 

https://archive.org/download/docsNearTalk_201705/Additio 

nalLibraries.odt 

Diari d’activitats 

https://archive.org/download/DiariActivitatsNearTalk/DiariAct 

ivitats.odt 

Storyboard projecte 

https://ia601509.us.archive.org/27/items/docsNearTalk_201 

7 05/NearTal k_Storyboard . pdf 

Presentacio 

https://archive.org/download/docsNearTalk_201705/present 

acioNearTalk.odp 

Demo aplicacio Android 
(Video) 

https://archive.org/details/final_20170519_1747 
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